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1 Introduction 

Using Bitmanagements technology it is possible to provide high level real-time 3d in a variety of 
applications. 

The following chapters provide general information on features of the BS Contact VRML browser. 

It discusses effective VRML design, and interfacing between HTML and VRML. There are also several 
extensions on VRML available, which are discussed in detail. The Scripting chapters provide a good 
resource for adding interaction to VRML scenes. 

Additional information and democontent can be found in the developer section of Bitmanagement 
Software’s website: http://www.bitmanaaement.de 


Technical specifications and further information about standards can be found here 


Consortia: 

Web3D 

http://www.web3d.org 

MPEG-4 

http://mpea.telecomitalialab.com/ 

MPEG-4 Industry Forum 
http://www.m4if.org 

H-Anim Working Group 
http://www.h-anim.org/ 

X3D Working Group 
http://www.web3d.org/x3d.html 

Standard Specifications 


NlRmL 97 

I SO. 1 1 EC 1 c-m-t- DS7 



3D ANYWHERE 


VRML Specification 

http://www.web3d.org/technicalinfo/specifications/vrml97/part1/nodesRef.html 


MPEG-4 Specification 

http://mpea.telecomitalialab.com/workina documents/mpea-04/svstems/3rd edition wd.zip 

X3D Draft Specification 

http://www.web3d.org/technicalinfo/specifications/ISO IEC 19775/index.html 


H-Anim Draft Specification 
http://www.h-anim.ora/Specifications/H-Anim2001/ 
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2 Feature overview 

BS Contact VRML is a multimedia client, already used by many internet users as a 3D viewer and 
communications client for the Virtual Reality Modeling Language (VRML) visualisations. BS Contact 
VRML, satisfying the standard VRML97, is the most universal VRML client on the market. 

As a proven, valuable and powerful client, BS Contact VRML is used for the visualization of interactive 3D 
content, like Virtual Worlds, 3D product presentation and avatars. 

The web-browser plug-in is compatible with the standard browsers Netscape 4.x and Microsoft IE (version 
4.01 and higher). BS Contact VRML runs on Windows 95, 98, Me, NT and 2000. 

A first overview can be found in the Bitmanagement Users Guide at 

http://www.bitmanagement.de/developer/contact/userguide/6.1/index, html 



A virtual environment where the user is part of it and can walk around and 
interact with objects. 



A CAD object that the user can can rotate and zoom into it while an 
animation demonstrates its functionality. 
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A product that the user can can rotate, zoom into and interact with it. 



VR scenes as they can be viewed in BS Contact need not to be 3D. This 
is an example of a 2D scene where the user can interact with it. Of course 
2D scenes can be intermixed with 3D objects. 


2.1 Full support of VRML97 Standard 

The Virtual Reality Modeling Language (VRML) is a file format for describing interactive 3D objects and 
worlds. BS Contact VRML is designed to be used on the Internet, intranets, and local client systems. 
VRML is also intended to be a universal interchange format for integrated 3D graphics and multimedia. 
BS Contact VRML may be used in a variety of application areas such as engineering and scientific 
visualization, multimedia presentations, entertainment and educational titles, web pages, and shared 
virtual reality. 

A complete description of the standard and related technology can be found at 
http://www.web3d.org 

VRML has been designed to fulfill the following requirements: 

Authorability 

Enable the development of computer programs capable of creating, editing, and maintaining VRML 
files, as well as automatic translation programs for converting other commonly used 3D file formats 
into VRML files. 

Composability 

Provide the ability to use and combine dynamic 3D objects within a VRML world and thus allow re¬ 
usability. 
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Extensibility 

Provide the ability to add new object types not explicitly defined in VRML. 

Be capable of implementation 

Capable of implementation on a wide range of systems. 

Performance 

Emphasize scalable, interactive performance on a wide variety of computing platforms. 
Scalability 

Enable arbitrarily large dynamic 3D worlds. 


VRML is capable of representing static and animated dynamic 3D and multimedia objects with hyperlinks 
to other media such as text, sounds, movies, and images. 

VRML supports an extensibility model that allows new dynamic 3D objects to be defined allowing 
application communities to develop interoperable extensions to the base standard. There are mappings 
between VRML objects and commonly used 3D application programmer interface (API) features. 


2.2 Full support of H-Anim 2001 


H-Anim 2001 nodes are supported as native nodes, including optimized vertex deformation code. 
BS-Exporter has been extended as well. Example scenes using H-Anim 2001 can be exported from 
Discreet 3D Studio Max. 


2.3 Support of MPEG-4 2D Nodes 

Using 2D and 3D nodes in a scene a true mixture between 2D and 3D graphics is possible. BS Contact 
VRML version 6.1 supports all MPEG-4 2D nodes. For more information, please see the nodes extension 
section of this document and the MPEG-4 specification 

http://mpea.telecomitalialab.com/workina documents/mDea-04/svstems/3rd edition wd.zip 


2.4 Basic support of X3D 

BS Contact 6.1 supports partially the X3D XML Encoding of VRML scenes. With Internet Explorer 
MSXML DOM Trees or strings with VRML or XML Encoding can be directly passed to Contact. This 
allows custom client side XML Processing. 

X3D defines an XML Encoding for VRML97 as well as a new revision of the standard. 

Contacts support the X3D XML Encoding of VRML Scenes. Proto,Externproto decoding are not yet 
supported. Also no new X3D nodes (Beside H-Anim/Nurbs) are supported. 

A new Contact COM Method load allows flexible parsing of XML or VRML Syntax from an in-memory 
representation. 


2.5 Viewpoints 

Viewpoints help the viewer in navigating a VRML scene. With the aid of viewpoints, designers can directly 
influence the positions that users occupy in a scene. 

Most 3D tools work with cameras, which are converted to viewpoints during VRML export. Viewpoints can 
also be animated to provide automatic movement such as, for example, a tour. 

Use the description field to specify a name for a viewpoint; this name will be displayed in the context 
menu (displayed by right-clicking in the scene). 
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2.6 Animation 

Objects can be animated in VRML. Plan your animations carefully. Use a small number of frames and 
change the 

cyclelnterval (animation duration) in the VRML code later. If several objects perform 
the same animation, combine them into a group so that the interpolators are 
only included in the file once. 


2.7 Large Scene optimization 


The range of large scene support tools have been completed with the support for OctTree's and 
QuadTree's Nodes. The higher level TreeGroup Node supports creating of OctTree, QuadTree and 
BspTree hierachies on the fly. The Nodes can be mixed. Such scene sorting helps the overall 
performance. In the OpenGL Driver for certain graphics cards additional support for Hardware assisted 
Occlusion Culling can be enabled. Occlusion Culling can cull scene grouping nodes or geometry nodes, if 
they are hidden by other geometry. 


2.8 Media integration 

BS Contact VRML uses several System ressources to play media files. Besides the DirectX components 
it can also access other installed media players. Because of that, it is possible to play much more media 
types than required from 
the VRML Spec. 

In order to have access to these media assets, it is necessary to use a MovieTexture node, even if the 
desired media is a pure audio file. Please note, that wav-files can be gzipped. BS Contact notices the 
compression 

and automatically unzips the files after downloading. Besides that, the audio file size may be reduced by 
audio sampling itself. 

2.8.1 Windows Media 

If Microsoft Windows MediaPlayer 6.4 or higher is installed, different Audio and Video formats are 
supported for streaming in the MovieTexture node. The URL information is passed to Media Players API 
for streaming. 

The URL protocols mms:// are treated as Window Media Media streamed URLs. Sound is decoded and 
played by Windows Media, so no spatialization of the sound is supported. The sound is played in addition 
to other VRML sounds or 

Contact text to speech with the Direct Sound driver. No status messages are displayed, usually the media 
starts playing after a while, once the buffering phase is completed. The initial stream opening currently 
blocks Contact for a short 
while. 

In Oder to synchronize animations with streamed content, MovieTexture node is extended with an 
eventOut SFTime mediaTime, where mediaTime reports the current play position time. Monitor this event 
to start animations. 

The following Media types are supported by Media Player 6.4 Sound formats: 

MIDI, MP3, WAV, WMA, ASF 


Video Formats: 
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MPEG, AVI, ASF, WMV 

ASX files are unsupported. But as an ASX files usually references one mms:// stream, you can reference 
it directly in the mms:// stream in the url field of the MovieTexture. 

By default the following file extensions are associated internally to Media Player: asf, au, avi, ivf, mid, 
midi, mpl, mp2, mp3, mp4, mpa, mpv2, mpe, mpeg, mpg, mpv, rmi, snd, wav, wma, wmv 


2.8.2 Real Media 

If RealPlayer G2/Real Player Plus G2 or higher is installed, RealAudio and RealVideo media are 
supported. The URL information is passed directly to the Real G2 subsystem and is played streamed. 

The URL protocols pnm:// and rtsp:// are treated as Real Media URLs. 

Sound is decoded and played by RealPlayer G2, so no spatialization or mixing with VRML sounds is 
supported. Only ONE Real G2 stream can play. Parallel usage of Real Player is currently not working. No 
Real status message are displayed. 

The media starts playing after a while, once the the buffering phase is completed. 


In order to synchronize animations with streamed content, the MovieTexture node is extended with an 
eventOut SFTime mediaTime, where mediaTime reports the G2 current play position time information 
Monitor this to start animations, once the content starts playing. 

A broad range of Audio and Video formats are supported by Real G2, if the codecs are installed. 
Examples include 

FLASH (.swf), MP3, m3u MP3 play lists etc. 


By default the following file extensions are associated internally to Media Player : 
ra, ram, rmm, rav, rm, rmp, rv, smil, smi, m3u, pis, swf. 

If a clip is started with a mouse click, we recommend to start the clip by assigning 
to the url. The Media layer already opens the stream with a given url, even when 
the clip is not playing. 

2.8.3 Textures 

BS Contact VRML supports these texture formats: 

• JPG (Joint Photographic Experts Group) 

• PNG (Portable Network Graphics) 

• GIF (Graphics Interchange Format) 

An alpha channel is required for textures with transparent regions; PNG and GIF 
provide that functionality. 

Keep textures small (image size and number of colors, if possible) to reduce download time for the user. 
Image resolution should be 72 dpi (screen quality, like for websites). 

To make efficient use of the texture memory in graphics cards, textures should be sized in powers of two, 
i.e. 32x32, 64x64, 64x128 etc. If possible, they should also be square. The maximum texture size that 
most graphics can deal with is 512x512 pixels. 

Reduce the number of textures by tiling them or reusing them for several objects. Ideally, use a single 
large texture containing the images for several objects. This is more efficient than the use of several small 
texture files since only one HTTP access is needed to download. 
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2.8.4 Other Media Types: 

MIDI files are not supported in the AudioClip but in the MovieTexture node. 

Example: 

Transform{ 
translation 0-10 
children[ 

Shape{ 

appearance Appearance { 
texture MovieTexture { 
url "jazz.mid" 
loop TRUE 

} 

} 

geometry Box {size 0.01 0.01 0.01} 

} 

] 

} 

If you need to play media types unsupported in VRML 97, Real or Windows Media you may always 
embed them in another (possibly hidden) HTML frame. If the media player has a script capable API 
playing still can be controlled from 3D. Of course you may embed the Real or Windows Media player too, 
providing the advantage of additional controls like title display, start, stop and volume controls. If the 
player does not allow to use the DirectSound engine cooperatively. 


2.9 Encrypted Content 

VRML content files can be encrypted via different encryption/authorization schemes. Content developers 
aquiring a BS Contact VRML Content licence are getting an encryption tool. The encryption tool supports 
different encodings and authorization modes. The encrypted files together with the content licence file are 
then placed on a Web-Server or CD-ROM. For more information please contact info@bitmanagement.de. 


2.10 Overview of Extensions 

In addition to the VRML97 format, BS Contact VRML supports the following extensions 

BumpMapping 
Multitexturing 
Particle Systems 
Nurbs 
Layers 

Cells&Portals 
BSP Trees 
Scripting 
2D graphics 
etc. 


A more detailed description can be found in the extension section of this document. 

2.11 BS SDK-Features: 


With the BS SDK package users can embed BS Contact VRML into their own applications. The following 
APIs, accompanied by documentation and exampleprogramms are available. 
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• Programmers Reference 

A description of the core APIs for all functional enhancements to BS Contact. The reference can 
be used for the integration of Java applets, scripts and C/C++ executables in order to support 
dynamic updates, user modifications and events including sounds and movies within a VR scene. 

• Content Authoring 

This section provides the content author in a first part with a complete description of the 
supported nodes and features. BS Contact VRML supports all VRML standard features. In 
addition the viewer has many Extensions enabling advanced features. The usage of all 
extensions is described on a technical level. 

In a second part the integration of an Automatic Installer for installation of BS Contact VRML into 
an application or product is described. 

• Tools 

This section illustrates BS Encrypt and BS Exporter. 

• Tutorials 

This section presents a set of simple applications/examples that shows step by step how to 
embed the BS Contact ActiveX control and how to access the scene graph. 


2.12 Licensing BS Contact VRML 


From testing the technology to licensing it the following steps may be taken 

1. BS Contact VRML shall be downloaded as "Unregistered Version" for testing. The viewer is not 
limited by function or time. A turning logo is displayed in the lower right corner. 

2. There is a Users Guide available explaining the way of using BS Contact VRML and BS Contact 
MPEG-4. 

3. A description of the functions and features of BS Contact VRML may be downloaded as well. 

4. The BS SDK Package supports integration of BS Contact VRML in third party applications like 
specific content or products. 
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5. Licensing scheme for unrestricted use of the player: 
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a) WEB Customer 
URL/Domain 



b) CDROM 
Customer 


c) Single Computer 
Customer 


BS Contact VRML may be enabled by Bitmanagement 

a. for the Internet / Intranet content by domain name or URL 

b. for the content on a CD ROM (e.g. by resulting checksum from content data) 

c. for content on a single computer by computer ID (e.g. by computer name) 

Enabling means that after licensing the restriction of BS Contact VRML - the turning logo - will be 
removed by Bitmanagement via a license key in a standard procedure. That "Registered Version" 
is then licensed for unrestricted use according to a-c. 


6. BS Contact VRML, BS Contact MPEG-4, BS Contact J, BS Optimizer, BS Exporter and BS SDK 
Package are for sale. 

Bitmanagement offers single contracts for one-time purchases, framework agreements as 
calculation base for multiple purchases and co-operation agreements in case a customers' 
business model relies on the technology. 

As we want to enable projects using the technology, pricing is on request and depends on the 
specific project or purpose of use. 


BS Contact MPEG-4 may be downloaded upon request of access information. The licensing scheme is 
the same. 


For BS Contact J there is an evaluation pachage available for download on request. 
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2.13 Main Creationtools 


Many creation tools can be used for authoring of 3D content for VRML. The following lists some of the 
market leaders: 


3ds max 
Maya 

Adobe Atmosphere 
Several CAD tools 
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3 Employing BS Contact VRML 


3.1 Preparation of a photo realistic 3D Model 

3.1.1 Starting with a photograph 

The basis for preparation of a photo realistic 3D model is appropriate photographic material of the object. 
Photographs showing all sides of the object are used for two purposes: 

1. From the photographs the texture is derived that is placed around the model. 

2. The photographs are used as a reference for the proportions of the model. 



Figure 1: Appropriate photographs in the 3D modeller 


3.1.2 Forming the shape of the model 

There are many different techniques for modelling products. In this case we start with a box shape which 
is similar to the figure of the real product. The grid-mesh is then adapted by hand to the model of the 
object. 
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Figure 2: Modelling the basic shape of the object. 


3.1.3 Adjusting the details 

Step by step the model is given more detail. The shapes of the camera, the navigation-button and the 
curvature of the storage battery are modelled. 


3.1.4 Making the texture 

The textures (photographs) define the colouring of the model and produce its photo realistic appearance. 
It is composed from different views, then retouched and adjusted some more with regards to its colours. 
In the process of texturing, each sub-area of the texture is assigned to the appropriate area of the model. 
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Figure 4: The texture is put on the model 

3.1.5 Finalising the model 

The model is about to be ready now. Finally it is exported via BS Exporter to VRML97 which is an 
interactive file format for the Internet. After optimisation in favour of a fast real-time performance with BS 
Internet Optimises it can be embedded into a FITML page. 

Once the model is done it can be used in many ways. 


1. It can be bundled with BS Contact Jfor product presentation. As an advantage for the user this 
technology does not require a plug-in installation and follows the lines of the everyday web usage of 
standard internet users. As it is based on software rendering, frame-rates and display performance is 
dependent on the general performance of the computer. 

2. It can be used as an input model for BS Contact VRML and BS Contact MPEG-4. 

The advantage of these plug-in technologies is its high rendering performance, as they use particular 
hardware features of the graphics card. With both these technologies complex geometry and large 
textures can be displayed at high frame-rates in full screen mode. 

3. In addition to these stand-alone applications the model can be embedded in a virtual world, e.g. for 
an e-shopping application. 
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Figure 5: The final model as it can be seen on the Internet. 

3.1.6 Directing the movement of the object (navigation) 

The model can be navigated by the internet user. Without a predefined navigation mode, it can be moved 
with the mouse by dragging the left button. Particular navigation modes (e.g. turn, zoom, walk and special 
animations) can be implemented and addapted for the customer’s needs, e.g.: 

a) simple 



1.1.1.1 


b) more complex 



rotate turn reset zoom pan 

c) for a particular animated object. 
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A predefined movement (tour) can be used for presentation as well. 


3.1.7 Inserting interaction 

Spots for retrieving additional information can be embedded all over the object. The user can trigger this 
information by clicking on these spots with the left mouse button. The additional information can include 
text, photographs, changes on the object and more information, 

e.g. 


• technical aspects 

• product pricing and delivery conditions 

• information about usage 

• information about optional parts 

• small audio files (ring tone) 

• changes of the object (e.g. modifications of colour and shape of the objects). 


Which complexity customers want to integrate in the object depends on the marketing concept. 


3.2 Embedding BS Contact VRML in a Webpage 

Because BS Contact VRML serves as a Browser Plug-In, it is embedded into html using the following tag 

<OBJECT CLASSID="CLSID:4B6E3013-6E45-11D0-9309-0020AFE05CC8" 

ID=Contact3D WIDTH=100% HEIGHT=85%> 

<PARAM NAME=''SRC" VALUE="yourVrmlFile.wrl"> 

<EMBED NAME="Contact3D" SRC="yourVrmlFile.wrl" 

TYPE="application/x-cc3d" WIDTH=100% HEIGHT=85%> 

</EMBED> 

</OBJECT> 

Please notice that a different tag is necessary for Netscape (’embed’) and InternetExplorer 
(’object’) and that booth tags need to be nested together. The value 
for CLASSID is the same for any implementations of BS Contact worlds. 

The embedded object can now be accessed by its name (for InternetExplorer ID) 

Contact3D through JavaScript. 
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4 BS Contact VRML Nodes Extensions 


4.1 Overview of VRML 


The virtual reality modelling language (VRML) is an international standard for interactive 3D graphics on 
the Internet. For details about the standard, see the Web3D Consortium’s at 
http://www.vrml.org/fs_specifications.htm. 

You can also download the VRML97 specification there. 

In the following example, we’ll briefly describe the scene graph using a block generated with an authoring 
tool e.g. 3ds max. 


The VRML Scene Graph includes: 

Nodes, the basic building blocks 

These nodes are arranged hierarchically and can also contain other nodes. 

• There are group, children and object nodes. 

• Each node describes a certain functionality, which is specified in detail by field in the node. 
The various components of VRML code are described in the following table. 


#VRML V2.0 utf8 
DEF QuaderOI 

Transform 

Nodes 

translation 

rotation 

scale 

Shape 

Material 

diffuseColor 


This line must appear at the beginning of every VRML 
file to identify it as such. 

The keyword DEF (define) is used to assign a name to 
a node; this node can be used later with the USE keyword, 
optimizing file size and memory use. 

This is a transform node that takes the block and moves 
it to a certain position in the 3D space and/or performs 
other transformations on it. This node extends from the 
first curly brace {to the last}. 

Nodes have typical characteristics that are more exactly 
specified by fields; for a transform node, these include 
translation, rotation, scale and scaleOrientation. 

Specifies the displacement in x y z. In the VRML coordinate 
system, x and z form a horizontal plane and y 
points up. 

Defines a rotation with 4 numeric values: a rotation axis 
(x y z) and an angle (w) given in radians. For example, 
a rotation of 180 degress around the y-axis: 0 1 0 3.14 
Defines scale factor for the x, y and z axes. For example, 
scale 2 2 2 scales the object by a factor of 2 in 
the x, y and z directions. 

This is the node that precisely describes the object; it 
has the fields appearance and geometry. 

This node provides details about the object’s appearance. 
Specifies the color values. VRML uses the RGB (additive) 
color model. For example, 111= white, 0 0 0 = 
black, 0 0 1= blue. All color values lie between 0 and 1. 


Additional material attributes include: 


ambientlntensity 

shininess 

specularColor 


Brightness (0-1); the higher the value, the brighter 
the color. 

specifies the smoothness/polish (0 -1) 

the spectral color, i.e. the color value of the shininess 
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transparency 

emissiveColor 

Box 


IndexedFaceSet 


(0 0 0 ) 

specifies the transparency: 0 = opaque, 1 = clear 
specifies the emission color 

geometry is specified by the primitive node Box. Other primitives include 
Sphere, Cone and Cylinder. 

This node (a set of polygons) is used to describe 
objects that can’t be described by primitives. 


4.2 Bitmanagement extensions augmenting the VRML Standard 

The following is a short description of the extension nodes in BS Contact VRML. The exact definition and 
parameters can be found in the SDK. 

BS Contact supports several VRML extensions. 

Extension nodes are native implemented EXTERNPROTO's. For VRML 97 conformance, a PROTO 
definition for the extension node should be added as follows: 

EXTERNPROTO ExtensionNode[ 

#fields, eventlns and eventOuts of that node 

] 

["urn:inet:bitmanagement.com:node:ExtensionNode", 

"http://www.bitmanagement.eom/vrml/protos/nodes.wrl#ExtensionNode"] 

If possible nodes have a useful fallback implementation. 

All built-in nodes can be referenced using the EXTERNPROTO URN syntax 

"urn:inet:bitmanagement.com:node:NodeType", the interface of the native node is used, not the interface 
of the EXTERNPROTO statement. 

Contact parses PROTO, ROUTES, EXTERNPROTO in all places a node value is expected. 


4.3 Avatar 

Avatars must be realized as Protos named 'Avatar'. It is nothing more then a very compact world fulfilling 
some constraints in dimensioning, file size, and interface. The constraints come from the fact, that your 
avatar must be loaded from each other visitor of the world, and becomes part of the world, affecting 
system resources, navigation speed etc. 

BS Contact supports a specialized optional Avatar interface used for a "Third Person" viewing mode, 
where you can see your own Avatar acting in the world. 

This avatar can reside in a file named "avatar.wri" in the BS Contact installation directory to be used in 
single-user mode or the selected avatar in multi-user mode will be used for third person mode. 


4.4 Background2D 

The Background2D node allows a background to be displayed behind a 2D scene. The functionality of 
this node can also be accomplished using other nodes, but use of this node may be more efficient in 
some implementations. 


4.5 Bitmap 

Bitmap is a geometry node centered at (0,0) in the local coordinate system, to be placed in the geometry 
field of a Shape node. It is a screen-aligned rectangle, which means that the surface normal of this 
rectangle will always be in the same direction as the screen surface normal, namely straight out to the 
viewer. It is for example not possible to view the Bitmap under an angle from the side. Bitmap has the 
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dimensions of the texture that is mapped onto it, as specified in the Appearance node of its parent Shape 
node. However, the effective geometry of Bitmap is defined by the non-transparent pixels of the image or 
video that is mapped onto it. When no scaling is specified, a trivial texture-mapping (pixel copying) is 
performed. 

Bitmap shall not be rotated but may be subject to translation. 

Geometry sensors shall respond to the effective geometry of the Bitmap, which is defined by the non¬ 
transparent pixels of the texture that is mapped onto it. 


4.6 BSP-Tree 

BS Contact supports a BSP-Tree node for optimal rendering performance of large worlds. 

The handling of large worlds is currently not well supported by VRML97 browsers. Browsers could 
implement view culling using bounding-box information stored in Group nodes, but typical scenes are not 
well organized spatially for this optimization. Even then a large amount of invisible geometry needs to be 
checked and passed to the rendering subsystem. 

A common solution used in games is to subdivide the world into smaller parts, where the browser can 
quickly decide to draw or not to draw a part. One method is the Binary Space Partitioning Tree (BSP- 
Tree). Here the world is divided by an infinite plane into the parts in front and behind the plane. The 
remaining parts themselves are recursively split until each part is a single object. 

In a true BSP-Tree, which can be rendered without the help of a z-buffer, each object is a single polygon. 
A polygon might be split if it crosses the plane of its parent tree node; a node stores also the list of 
polygons exactly on the plane. 

In a hybrid approach, objects need not be decomposed or can be combined with dynamic, moving parts 
that are not part of the BspTree hierarchy. Here z-buffering is enabled to ensure correct visibility. 


4.7 BSPGroup 

The BSP-Group is a simplified approach of the BSP-Tree. The BSP-Group specifies as children a list of 
nodes, where a BSP-Tree is automatically constructed. A Group with a big list of static children could 
simply be replaced by a BSP-Group node. 


4.8 BumpTransform 

The new BumpTransform Node allows to transform the bump mapping offsets. 

BS Contact 5 introduced a flexible Multi Texture Framework, BS Contact 6 now adds the missing support 
for environment mapped bump mapping. See the examples. 

Environment mapped bump mapping applies a per-pixel texture coordinate perturbation of specular or 
diffuse environment maps. This perturbation requires a special DSDT texture format which encodes a 
shift vector instead of a color value. 

This format has been introduced by Matrox on the G400 and is now supported on Nvidia Geforce 3 and 
up and ATI Radeon graphics cards. These formats are *not* available on older cards e.g. Geforce 2. 


4.9 Camera 

The Camera node enables content authors to design their own navigation. 

All standard modes, like WALK, SLIDE, PAN, and FLY, are realized by applying different values to the ypr 
(yaw, pitch, roll) and the xyz field. 
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4.10 Cell 

The Cells & Portals technique allows the visibility management of complex indoor environments. For 
further details, please read the documentation at Cell&Portals. 

The Cells & Portals technique also combines several Extension nodes. Please see node definitions for 
Cell and Portal. 


4.11 CellGroup 

The Cells & Portals technique allows the visibility management of complex indoor environments. For 
further details, please read the documentation at Cell&Portal. 

The Cells and Portals technique also combines several Extension nodes. Please see the node definitions 
for Cell and Portal. 


4.12 Coordinate2D 

This node defines a set of 2D coordinates to be used in the coord field of geometry nodes. 

The point field contains a list of points in the 2D coordinate space. 

This is the 2D equivalent to the VRML97 Coordinate. It is reqired for Curved2D, lndexedFaceSet2D, 
lndexedLineSet2D and PointSet2D. 


4.13 Coordinatelnterpolator2D 


This node fills the gap of the missing 2D Interpolators in the VRML97 Spec. The node works like a 
common Coordinatelnterpolator with the difference of the keyValues being multiple SFVec2f values. 


4.14 CompositeTexture3D 

This node allows you to render a subscene dynamically to a texture. It can only be used as a texture field 
of an Appearance node. Please see also the chapter Multitexturing. 

Behaviors and user interaction are enabled with CompositeTexture3D. However, no user navigation is 
possible on the textured scene and sensors contained in the scene which forms the CompositeTexture3D 
shall be ignored. 

CompositeTexture3D is supported by software and most hardware drivers. CompositeTexture3D 
depends on size and number of node instances and can use extensive video memory resources. You 
should take care to ensure enough video memory is available. 

CompositeTexture3D is not supported in the OpenGL render engine. 


4.15 CullGroup 

Cullgroup is a group with an automatic bounding box computation for the children scene graph. Useful for 
early render culling of complex scene graphs (e.g. Avatars). 
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4.16 Curve2D 

This node is used to describe the Bezier approximation of a polygon in the scene at an arbitrary level of 
precision. It behaves as other "lines", which means it is sensitive to modifications of line width and 
"dotted-ness" and can be filled or not. 

The given parameters are a control polygon and a parameter setting the quality of approximation of the 
curve. Internally, another polygon of fineness points is computed on the basis of the control polygon. 


4.17 DeviceSensor 

The DeviceSensor node observes arbitrary input devices such as a six degrees-of-freedom mouse or a 
speech recognition system, but certainly also standard input devices like mouse or keyboard. The device 
data is wrapped in an Event node (already suitable for many possible event types). Special-purpose 
devices may replace the default implementation with their own Event node, guaranteeing maximum 
flexibility for all possible input devices. 


4.18 Displacer 

This node belongs to the Humanoid Animation Specification (H-Anim). 

An H-Anim file contains a set of Joint nodes that are arranged to form a hierarchy. Each Joint node can 
contain other Joint nodes, and may also contain a Segment node which describes the body part 
associated with that joint. Each Segment node can have a number of Displacer nodes that specify which 
vertices within the segment correspond to a particular feature or configuration of vertices. 


4.19 DrawGroup 


DrawGroup allows the content author to influence transparency processing. Wrapping a set of geometry 
into DrawGroup processes any geometry (even transparent ones) in the exact order given by children. 
This is useful for mirror- like effects or for turning off delayed alpha blending for sets of geometry with bi¬ 
level transparency only. 


4.20 DrawOp 

Instead of using MultiTexturing, geometry can be drawn in multiple pathes using different rendering 
attributes. This can be achieved using the extension nodes DrawGroup and DrawOp. The drawback is 
that geometry is drawn several times. The benefit is that an arbitrary number of effects can be combined 
and the feature will work on all graphicsboards. Multipath rendering can also be used to use the output of 
radiosity programs to combine it with the basic unlighted textured scene. 


4.21 Event 

The Event node is a speciality in this list of nodes because it is not used as a node in the scene graph. 
Instead it is returned by eventOut of Sensors such as the DeviceSensor. This node is modelled after the 
W3D-DOM. For further details on this, please also read this specification. 
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4.22 Fog2 

Fog2 is like fog with the additional parameter visiblityStart for linear fog. As Direct3D does not support 
exponential fog, linear fog starts per default at 0 in VRML often causing premature blending with the fog 
color. 


4.23 HUD 

A HeadUpDisplay is a common geometry, which is 'carried' with the user in his viewing frustum. This may 
be useful for designing user interfaces in 3D. 

This node is equivalent to a VRML HUD construct using a Transform, ProximitySensor, and Collision { 
collide FALSE }. 

Children are displayed relative to the viewer and not relative to the avatar position in 3rd person viewing 
mode. 

For the known problems with this node (possible collision with world geometry, incorrect position in 3rd 
person mode, etc.), we recommend using the nodes Layer2D or Layer3D instead of this one. 


4.24 Humanoid 

This node belongs to the Humanoid Animation Specification (H-Anim). 

An H-Anim file contains a set of Joint nodes that are arranged to form a hierarchy. The file also contains a 
single Humanoid node which stores human-readable data about the humanoid such as author and 
copyright information. That node also stores references to all the Joint, Segment and Site nodes, and 
serves as a "wrapper" for the humanoid. In addition, it provides a top-level Transform for positioning the 
humanoid in its environment. 


4.25 ImageTexture 

Besides the common standard fields of the ImageTexture node, BS Contact supports additional fields to 
provide better download control. 


4.26 Inclusion 

In order to provide better culling mechanisms for complex scenes, we proposed several nodes, which 
help in optimizing content. The idea is that once you are inside a room, you cannot see anything outside. 
Children of an Inclusion node are only traversed if the viewpoint is in one of the proxy objects or if proxy is 
NULL. In combination with BspTrees, if an Inclusion node becomes active, the node signals the BspTree 
logic to stop processing. 

The current implementation allows the following nodes inside the proxy scene graph: Group Transform, 
Box, Sphere, Cylinder, IndexedFaceSet (must be convex). 


4.27 lndexedFaceSet2D 

The lndexedFaceSet2D node is the 2D equivalent of the IndexedFaceSet node. The lndexedFaceSet2D 
node represents a 2D shape formed by constructing 2D faces (polygons) from 2D vertices (points) 
specified in the coord field. The coord field contains a Coordinate2D node that defines the 2D vertices, 
referenced by the coordlndex field. The faces of an lndexedFaceSet2D node shall not overlap each other. 
The semantics are identical to those for the IndexedFaceSet node, restricted to the 2D case, and with the 
some additional differences. 
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4.28 lndexedLineSet2D 

The lndexedLineSet2D node specifies a collection of lines or polygons. 

The semantics are identical to those for the IndexedLineSet node, restricted to the 2D case, and with the 
some additional differences. 


4.29 Inline 

In addition to the node definition in the VRML standard also the following fields are supported: 

Eventln SFBool set_unload 
EventOut SFBool is Loaded 


4.30 Inline2 

In order to have more control over the loading process of an Inline node and the processed nodes, this 
node provides several additional fields compared with a common Inline node. 


4.31 Joint 

This node belongs to the Flumanoid Animation Specification (Fl-Anim). 

An Fl-Anim file contains a set of Joint nodes that are arranged to form a hierarchy. Each Joint node can 
contain other Joint nodes, and may also contain a Segment node which describes the body part 
associated with that joint. 


4.32 KeySensor 

This node catches all keyboard events. If certain keys are normally associated to the browser, they are 
neither processed in the scene nor by the browser. Following the W3C-DOM-proposal we propose adding 
an eventsProcessed field. If there are multiple KeyboardSensors and/or StringSensors in a world, only 
one will generate events at any given time. 

Note: KeySensor is not affected by its position in the transformation hierarchy. 


4.33 Layer2D 

Layer2D is an MPEG4 node, which is used for scene composition in terms of 2D scenes. The Layer2D 
node is a transparent rendering rectangle region on the screen where a 2D scene is drawn. The rectangle 
always faces the viewer of the scene. In opposition to Layer3D, this Layer node draws 2D components 
(without depth). 


4.34 Layer3D 

The Layer3D node is a transparent rendering rectangle region on the screen where a 3D scene is shown. 
The Layer3D is part of the layer's hierarchy and can be composed in a 2D environment with depth. 
Layer3D nodes enable the composition in a 2D space with depth of multiple scenes. This allows users to 
view a 3D scene from different view points in the same scene or view different 3D scenes in the same 
scene, for example. 

A common use for this might be a rear view mirror in a car or a User Interface overlaying a 3D scene. 
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4.35 LineProperties 

The LineProperties node specifies line parameters used in 2D and 3D rendering. 

The lineColor field specifies the color with which to draw the lines and outlines of 2D geometries. 

The lineStyle field shall contain the line style type to apply to lines. 

The width field determines the width, in the local coordinate system, of rendered lines. The width is not 
subject to the local transformation. 


4.36 Material 

Material transparency is blended with transparent textures or transparent GIFs. This is not VRML97 
compliant, but was a demand from content developers. See also the MultiTexture node for the option of 
blending material color with textures. 

Material should be used for Bitmap, Box, Cone, Cylinder, ElevationGrid, Extrusion, IndexedFaceSet, 
IndexedLineSet, PointSet, Sphere and Text. 


4.37 Material2D 

The Material2D node specifies the characteristics of a rendered 2D shape. Material2D shall be used as 
the material field of an Appearance node in certain circumstances. 

Material2D should be used for Bitmap, Circle, Curve2D, lndexedFaceSet2D, lndexedLineSet2D, 
PointSet2D, Rectangle and Text. 

When color field is non-null the color(s) are used either to fill the faces or to draw outlines of the faces 
depending on whether Material2D filled field is true or false respectively. In addition, if the filled field is 
true and the Material2D lineProps field is non-null then lines are drawn using the LineProperties lineColor 


4.38 MatrixTransform 


The Matrixtransform replaces the Transform standard node and allows to specify an coordinate 
transformation as a 4 x 4 matrix. The SFMatrix field data type is an extension of BS Contact VRML and 
expects 16 float values without enclosing [ and ] braces. 


4.39 MenuSensor 

MenuSensor displays a VRML-defined menu in the Contact 3D as right click pop-up menu. On activation 
of a menu entry, the corresponding choice value is sent as eventOut choice. A choice value of -1 
indicates a menu separator. 


4.40 MouseSensor 

Analogous to the KeyboardSensor we define a MouseSensor that reports the events of the mouse. 


4.41 MovieTexture2 

Besides the common standard fields of the MovieTexture node, BS Contact supports additional fields to 
provide better media control. 
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4.42 MultiTexture 

MultiTexture enables multi-texturing: a 3D object is textured with a texture composed from several 
individual textures. Use it as a value for the texture field in an Appearance node. 

4.43 MultiTextureCoordinate 


MultiTextureCoordinate is used in combination with Multitexture. This node is used to hold the texture 
coordinates for the several textures. 

For a MultiTexture node with an IndexedFaceSet without a MultiTextureCoordinate texCoord node, 
texture coordinates for channel 0 are replicated along the other channels. Likewise if there are too few 
entries in the texCoord field, the last entry is replicated. 


4.44 Nurbs 


As part of our development efforts for Pentium® III support, we have implemented NURBS technology. 
With NURBS, complex 3D curves are represented with a minimum of data, allowing a new level of visual 
display and animation quality for Internet-delivered 3D graphics. 

To learn about NURBS development, including NURBS-related settings in BS Contact, sample content, 
project results and our proposed NURBS extension for VRML97 take a look at the developer section of 
our website at http://www.bitmanaaement.de . 

Trimmed NURBS extension nodes: 

• Contour 

• Polyline2D 

• NurbsCurve2D 

• TrimmedSurface 

A conversion utility from Openlnventor NURBS format to VRML is also available from the NURBS project 
page. 

The Nurbs extension is a VRML 97 amendment. 


4.45 Occlusion 

In order to provide better culling mechanisms, especially for complex scenes, which consist of indoor and 
outdoor parts, we proposed several nodes. 

Occlusion is a Group node with an additional proxy geometry triggering an inside/outside processing. 
Children are meant to contain the inside view of the room; proxy is supposed to contain the bounding 
shape for the room (e.g. a Box {} node). 

During traversal the current viewpoint is compared with all Geometry nodes in the proxy subgraph. If the 
viewpoint is outside all Geometry nodes, children will not be visible. If the viewpoint is inside the proxy, 
the children will be visible. 

Whenever children become visible or invisible, isActive, enterTime and exitTime events are generated 
similar to the ProximitySensor. Occlusion's behavior can be switched to the normal group behavior by 
setting enabled to FALSE. This is designed for cases where the room becomes temporarily visible from 
the outside, for example if a door or window has been opened, to look inside the room. 


4.46 Occlusion culling 

With the Contact OpenGL renderer occlusion culling can be enabled. If the scene is sorted and rendered 
in front to back order, there is a chance the objects in the back are hidden by objects already drawn. The 
occlussion culling test is performed by drawing proxys of grouping nodes with bounding boxes given or 




Bitmanagement 
Software GmbH 


geometry to see if there are still visible pixels left for the box. If the node's proxy is invisible it can be 
skipped. 

For more information, please see the BSP-Tree section at http://www.bitmanaaement.de/develooer 


4.47 OctTree 


The OctTree node splits a 3D box volume into 8 equal sized sub volumes. 

The elements 0..7 of the children field are denoting the 8 subtrees. An entry can be NULL if there are no 
further sub-nodes. 

The rest from index 8 to length of children are nodes which are overlapping (i.e. can't be put in 
subvolumes), but they are guranteed to fit in the box volume set by bboxCenter, bboxSize. 

Subnodes nearer to the viewer are traversed first. 

For more information, please see the BSP-Tree section at http://www.bitmanaaement.de/developer 


4.48 OrderedGroup 

The OrderedGroup node controls the visual layering order of its children. When used as a child of a 
Layer2D node, it allows the control of which shapes obscure others. When used as a child of a Layer3D 
node, it allows content creators to specify the rendering order of elements of the scene that have identical 
z values. This allows conflicts between coplanar or close polygons to be resolved. 

Since 2D shapes have no z value, this is the sole determinant of the visual ordering of the shapes. 
However, when the OrderedGroup node is used with 3D shapes, its ordering mechanism shall be used in 
place of the natural z order of the shapes themselves 


4.49 Particle Systems 

The Particles node, a Geometry node, creates a dynamic generated Particle System. Particles are 
rendered per default as a textured billboarded quad. They are emitted from a sphere centered at 
emitterPosition. Each particle internally stores the properties position, velocity, radius, RGBA color, 
lifeTime 

Several variables can be randomized using the corresponding variation parameter. 

Particles are not selectable or collidable. 


4.50 PixelTexture 

In addition to the node definition in the VRML standard also the following field is supported: 
MFString parameter [] 


4.51 PointSet2D 

This is a 2D equivalent of the PointSet node, with semantics that are the 2D restriction of that node. 


4.52 Portal 

The Cells & Portals technique allows the visibility management of complex indoor environments. For 
further details, please read the documentation at Cells&Portals. 

The Cells & Portals technique also combines several Extension nodes. Please see the node definitions 
for Cell and CellGroup. 




© Bitmanagement 
Software GmbH 


4.53 Positionlnterpolator2D 

This node fills the gap of the missing 2D Interpolators in the VRML97 Spec. The node works like a 
common Positionlnterpolator with the difference of the keyValues being multiple SFVec2f values. 

A common use for this node is, for example, texture animation. In this case this Interpolator would drive a 
TextureTransform node. 


4.54 ProceduralTexture 

Procedural texture computes Texture images on the fly based on Ken Perlin's noise function. 

An example can be found in the release notes of BS Contact VRML 6.1 at 
www.bitmanaaement.de/develoDer 


4.55 QuadTree 

The QuadTree node splits a 2D rectangle area in the x z plane into 4 equal sized sub rectangles. 

The elements 0..3 of the children field are denoting the 4 subtrees. An entry can be NULL if there are no 
further sub-nodes. 

The rest from index 4 to length of children are nodes which are overlapping (i.e. can't be put in 
subvolumes), but they are guranteed to fit in the box volume set by bboxCenter, bboxSize. 

Subnodes nearer to the viewer are traversed first. 

For more information, please see the BSP-Tree section at 
http ://www. bitmanaaement.de/developer 


4.56 Rectangle 

This node specifies a rectangle centered at (0,0) in the local coordinate system. The size field specifies 
the horizontal and vertical size of the rendered rectangle. 


4.57 Scene 

The Scene node describes major attributes of a VR scene, such as the overall bounding box or a list of all 
Viewpoints. 

It is not a node that one puts into a content file or creates by intent, but rather a node that is used 
internally by BS Contact and is exposed to an application from the BS SDK package. For example when 
an application dynamically creates a sub scene BS Contact returns it a Scene node that describes the 
scene. Scene nodes can be part of another scene graph, in which case they act as a grouping node and 
define separate name spaces. The Scene node is not a node that 


4.58 Script 

Extensions regarding the Script node are discussed in detail in chapter Scripting extensions. 
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4.59 Segment 

This node belongs to the Humanoid Animation Specification (H-Anim). 

An H-Anim file contains a set of Joint nodes that are arranged to form a hierarchy. 

Each Joint node can contain other Joint nodes, and may also contain a Segment node which describes 
the body part associated with that joint. 


4.60 Selection 

Similar to a Collision node this node allows you to define an invisible mouse selection proxy (e.g. large 
rectangle for text, bigger box for a finely detailed geometry) or to turn off selection completely (i.e. to pick 
through transparent shapes). 


4.61 Site 


This node belongs to the Humanoid Animation Specification (H-Anim). 

An H-Anim file contains a set of Joint nodes that are arranged to form a hierarchy. Each Joint node can 
contain other Joint nodes, and may also contain a Segment node which describes the body part 
associated with that joint. Each Segment can also have a number of Site nodes, which define locations 
relative to the segment. Sites can be used for attaching clothing and jewelry, and can be used as end- 
effectors for inverse kinematics applications. They can also be used to define eyepoints and viewpoint 
locations. 


4.62 Sound2 

The Sound2 node extends the Sound node to support the sound cone model of Microsoft Direct Sound, 
this finally allows a directed cone sound model and some more effects. 

6.1: Uncompressed Multi-channel WAV Audio files are supported. All channels are heard only with a 6.1 
speaker set-up. There is no automatic 2 channel downmix, with stereo speaker setup only the front-left 
and front-right channels are audible. 


4.63 Text/FontStyle 


A common problem with Text nodes in VRML is the high number of triangles produced because of the 
necessary tesselation. With Contact 4.3 and higher there is an option to create a textured rectangle for 
each character. The user supplies a special Font texture in an ImageTexture node and sets the fontstyle 
family attribute to "TEXTURE". 


4.64 TextureCoordGen 

The TextureCoordGen node allows to automatically generate texture coordinates for geometry shapes 
algorithmically. It can be used to set the texture coordinates for a node with a texCoord field. 

The different texture generation modes are available. Some of them are view dependent and some may 
be hardware accelerated, e.g. they are not slowing doing rendering significantly. 
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4.65 TextureMatrixTransform 

This node can replace the TextureTransform standard node and allows to specify the texture 
transformations in form of an arbitrary 4x4 matrix. 


4.66 Transform2D 

The Transform2D node allows the translation, rotation and scaling of its 2D children objects. 


4.67 TreeGroup 

The TreeGroup nodes hosts an sorted Quad/Oct scene tree in its tree SFNode field. 

For convienience the children field can contain an unsorted flat list of Shape & Group nodes as the leaves 
for the tree. If the buildTree flag is TRUE the tree will be (re)computed from the list of leaf nodes. 

The Sorting tree can be hybrid, ie. can use OctTree, QuadTree, BspTree or Group nodes as applicable. 
The treebuilder computes & sets the bboxSize & bboxCenter fields. 
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5 BS Contact VRML scripting extensions 

5.1 General 

VRML content using the features in this section is NOT compatible with other 
VRML browsers unless the script contains fallback code for other browsers. 

In the Script node interface exposedFields are allowed. An exposedField 
behaves as a field combined with an eventln and eventOut. This feature often 
simplifies PROTO authoring. 

Example: 

PROTO MyTransform [exposedField SFVec3f translation 1 2 3] 

{ 

Transform {translation IS translation } 

Script { 

exposedField SFVec3f translation IS translation 
url "javascript: 
function translation(v) 

{ 

print('Translation changed to ’+v); 

} 

"} 

} 

Assignments to eventOut or assignment to node fields ("directOutput") will 
directly trigger any attached routes. eventOuts of the Script are not delayed 
triggered at the end of the Script execution as described in the VRML 97 spec. 

5.2 Browser object extensions 

additional member functions 

void print(string) - print the string to the console. A typical use is to debug scripts. 
Too many prints can slow down performance due to the console update. 

function x(value) { Browser.print(' value is ’+value);} 

In order to print timestamps easily, the following code fragment can be used: 
Browser.print('Time = '+ (timeStamp -Browser.getWorldStartTime())); 

For compatibility with other VRML browsers, the built-in functions print(string) 
and trace(string) are supported. 

createVrmIFromString - 'knows' PROTO definitions in the top-level VRML file, 
(non-standard!) 
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Time 


float getCurrentTime() 

Gets the computer's current 
system time 

float getTime() 

Gets the browser's current 
simulation time 

float getWorldStartTime() 

Gets the time the world was 
loaded 


Avatar 


void setMyAvatar(node) 

Sets the avatar for 3rd person 
mode display 

bool showMyAvatar(flag) 

Toggles 3rd person mode 
on/off 

bool getThirdPersonView() 

Returns state of 3rd person 
mode 


Sound 


void setSoundEnabled(flag) 

Sets false to lock the usage of 
the sound device for this 

scene 

bool getSoundEnabled() 

Returns current state of sound 
enabled state 


Navigation 


void 

setNavigationMode(string) 

Changes navigation mode 

string getNavigationMode() 

Returns the active navigation 
mode (Contact 4.0 or higher) 
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void 

setCollisionDetection (flag) 

Changes collision detection 
mode 

bool 

getCollisionDetection() 

Returns state of collision 
detection 

void setGravity(flag) 

Changes gravity = terrain 
following mode 

bool getGravity() 

Returns current state of gravity 

void setHeadlight(flag) 

Changes headlight mode 

bool getHeadLight() 

Returns current state of 
headlight 

void 

setViewpointAnimation 

(flag) 

If flag is TRUE, viewpoint 
changes are animated, 
otherwise immediate. 

bool 

getViewpointAnimation() 

Returns current state of 
viewpoint animation 

void 

setAvatarHeight(float) 

Sets the avatar height. Used 
for computing distance of 
viewpoint to ground (see 
appropriate field of 

Navigationlnfo node). 

float getAvatarHeight() 

Returns current avatar height 

float getStepOverSize() 

Returns current step over size 

void 

setCollisionDistance 

(float) 

Changes the collision distance 

float 

getCollisionDistance() 

Returns current collision 
distance 

void 

setVisibilityLimit(float) 

Changes visibility limit 

float getVisibilityLimit() 

Returns current visibility limit 

void setWalkSpeed(float) 

Changes walk speed 

void setViewpointByValue 
(SFVec3f position, 

SFRotation orientation, 
int mode) 

Sets current viewpoint position 
to position/orientation 

Allowed Modes: 

bit 0: 1 animated transition, 0 

not animated 

bit 1: 1 sets absolute viewpoint 
(unbind any bound viewpoint) 
bit 2: 1 values are a relative 
move distance (left/right, 


getViewpointByValue 
(SFVec3f position, 
SFRotation orientation, 
int mode) 


Userlnterface 


boolean 

isKeyPressed(int keyCode) 

Node mouseSelect 
(SFVec2f startPoint) 


URL 
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up/down, > in/out, look 
left/right, look up/down, roll,) 
bit 3: 1 check for collision, 0 
not 

bit 4: 1 check for ground 
detection, 0 not 
You can program custom 
navigation with this function: 
For navigation a new relative 
move distance is computed 
from user input and passed to 
the Browser as 

Browser.setViewpointByValue( 
distance,rotation,(4+8+16)); 

In relative move (bit 2, value = 
4) the orientation axis is 
interpreted as 3 rotation 
angles about the relative x, y, 
z axes of the camera. 

returns current viewpoint 

position 

Modes: 

0: return data of local 
viewpoint 

1: global viewpoint, value of 
local viewpoint transformed to 
global coordinates if bound 
viewpoints are inside a 
Transform Node 
2: 3rd person mode viewpoint 


Determines by keyCode if the 
virtual key is currently pressed 

Computes an intersection of a 
ray from the given 2D mouse 
position with the scene graph. 
Result is null if no intersection 
found or a PseudoNode 
RayHitlnfo. 


string getWorldBaseURL() 


Returns the base URL of the 


string getBaseURLQ 


loadURLrel 
(MFString url, 

MFString parameters) 

Rendering 

void setRenderMode(string) 

float getZNear() 
float getZFar() 

VRML Browser window 

int getWindowSizeX() 
int getWindowSizeY() 
float getWindowAspect() 
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top-level world 

Returns the base URL for the 
script node 

URLs inside EXTERNPROTO 
instanced VRML nodes are 
relative to the VRML world 
where they are found. 
getBaseURL returns the 
baseURL of the VRML file 
containing the Script node. So 
this call resolves common 
authoring problems if URL 
references in the PROTO are 
relative to the implementing 
PROTO. 

Same as loadURL except URL 
is relative to getBaseURLQ 


Changes rendering mode. 
Supported values are 'Flat', 
'Gouraud', 'Wireframe', 
'Vertices'. The OpenGL 
Tenderer additionally supports 
'Solid NonLighted 
BoundingBoxes'. 

Returns current znear clipping 
value 

Returns current zfar clipping 
value 


Returns the horizontal size in 
pixels of the rendering window 

Returns the vertical size in 
pixels of the rendering window 

Returns the aspect ratio 
(width/height) of the rendering 


Client System 


int getCap(int what) 


String 

getlnstallDirecto ry() 

bool setOption 
(String option, 

String optionValue) 
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window, useful to adjust 
overlays 


Returns browser capability information. 
Example usage: adapt content to client 
platform, check if a certain feature like alpha 
blending is present. 

Capabilities: "OpenGL" "Direct3D" 
"ISJHARDWARE" 

"TOTAL_VIDEO_M EMORY" 
"FREE_VIDEO_MEMORY" "RGBJJGHTING" 
"ALPHA_BLENDING" "MIPMAPPING" 
"MAXTEXTURESIZEX" 
"MAXTEXTURESIZEY" 
"TEXTURESQUARE" "MAXLIGHTS" 
"FREETEXTUREMEMORY" 
"TOTALTEXTUREMEMORY" 
"FREEPHYSICALMEMORY (KB)" 
"TOTAL_PHYSICAL_MEMORY (DB)" 
"USED_PHYSICAL MEMORY %" 


Returns the string of the directory where BS 
Contact resides 
List of setOption values: 

antiAliasing ("TRUEVFALSE") 
collisionDetection("TRUE7"FALSE") 
dithering ("TRUETFALSE") 
exactCollision ("TRUETFALSE") 
fullScreen ("TRUETFALSE") 
gravity ("TRUETFALSE") 

ISSE ("TRUETFALSE"; Katmai ISSE 
instructions on/off) 
mipmap ("TRUETFALSE") 
lodScale (float global scale factor for 
visibilityLimit, LOD (same as performance 
visibilty factor)) 

lightScale (float global scale factor for light 
intensity) 

NurbsTesselationScale (float) 
NurbsTargetFps (float) 
NurbsTessellationMode (int NURBS 
tesselation mode : 

0 STATIC_TESSELATION 

1 DYNAMIC_TESSELATION 

2 FRAMERATE_TESSELATION 

3 DYNAMIC_FRAMERATE_TESSELATION) 


relativeTime ("TRUETFALSE") - changes 


string getOption 
(String option) 
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timebase to 'relative to the load time of the 
scene', FALSE seconds since 1970 (VRML97 
notion) 

resetRelativeTime (sets the local timebase for 
relativeMode to 0) 

refreshTime (sets the Contact cache session 
reference time to now) 
smooth ("TRUETFALSE") Smooth texture 
filtering 

soundQuality (int Sound quality settings (initial 
value)) 

soundDopplerFactor (float - sets the Direct 
Sound doppler factor) 
soundRolloffFactor (float - sets the Direct 
Sound rolloff factor) 

soundVelocity (vx vy vz - sets the Direct 
Sound listeners velocity) 
texturing ("TRUETFALSE") Texturing enable / 
disable 


See list above. 


Memory Management 


setUnloadMode 

(int minNotActivelnlines, 

float percentageFactorToPurge) 


int prefetch 
(MFNode argument, 
boolean loadlnlines, 
boolean loadTextures) 


Sets strategy for purging inlines from memory: 
If the number of inlines currently not rendered 
is greater than minActivelnlines, purge up to 
(number * percentage) inlines from memory. 

If percentage < 0, there is an absolute number 
of inlines to purge. 

Example: 

setUnloadMode(100,0.05) 

If more than 100 inlines are currently not 
rendered, delete the 5 % of the inlines least 
recently used. 

Instructs the browser to load the media 
resources listed in argument. Parameters 1 
and 2 are true by default. 

If argument directly references ImageTexture, 
MovieTexture, Inline, Script or AudioClip 
nodes, the return value is the number of those 
nodes loaded. 


VRML Scene 


Node getScript() 


setBspMode(order) 

setBspLoadingMode(order) 


Node computeRayHit 
(SFVec3f startPoint, 
SFVec3f endPoint, 

Node optionalStartingNode) 


Node computeCollision 
(SFNode sourceNode(geometry), 
VrmIMatrix sourceMatrix, 

SFNode targetScenegraph, 
VrmIMatrix targetMatrix) 
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Returns an SFNode referring to the Script 
node of the script. Often script authors need to 
have a "this" reference in a Script. The 
common method using an extra SFNode field 
in the Script field list is possible too but may 
result in memory leaks in Contact. 

Sets bsp traversal order 

Sets bsp inline traversal order 
TRAVERSE_NORMAL 0 
TRAVERSE_BACK_TO_FRONT 1 
TRAVERSE_FRONT_TO_BACK2 

Computes an intersection of a ray with the 
scene graph. Result is null if no intersection is 
found, otherwise a PseudoNode RayHitlnfo 
with this information: 

PROTO RayHitlnfo [ 
eventOut MFNode hitPath 

# the chain of grouping nodes, to the geometry 
node intersected 

eventOut SFVec3f hitNormal 

# normal at point of intersection 
eventOut SFVec3f hitPoint 

# point of intersection in global world 
coordinates 

eventOut SFVec2f hitTexCoord 

# texture coordinate at point of intersection 
(without any texture matrix applied) 
eventOut SFMatrix hitMatrix 

# matrix transforming shape local coordinates 
to world coordinates 

eventOut SFVec3f hitNormalLocal 
eventOut SFVec3f hitPointLocal 

# intersection point in the shape's local 
coordinate system 

eventOut MFInt32 hitlnfo 

# vertex index information 

] 


Computes collision between a geometry node 
and the scene graph. Source and targetMatrix 
describe the transformation of source 
respective to scene graph. Use them for 
moving systems (e.g. sourceNode is a 
(moving) ball and sourceMatrix contains the 
current transformation). Result is null if no 
intersection found or a PseudoNode 
Collisionlnfo with the following information: 
PROTO Collisionlnfo [ 
eventOut MFNode hitPath 
# the chain of grouping nodes the geometry 
node source collided with 
eventOut SFMatrix hitMatrix 
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# matrix transforming local coordinates to 
world coordinates 

eventOut MFInt32 hitlnfo 

# vertex index information 


] 


Click the cylinder, console displays collision 
information. Arguments 2 ..4 are optional, as 
matrix null value can be passed. 

Collision has more performance if matrices do 
contain only uniform scale. All Contact space 
subdivision techniques like Groups with 
bboxSize and BspTree are fully exploited for 
speedup if used in the target scene graph. 


5.3 Browser object properties 

The Browser object itself is a VRML node with certain events and fields. By 
adding ROUTES from vrmlscript or eventOut Observers from the EAI, these 
events can be observed. 

Access from vrmlscript: Browser.xxx 

Access from EAI: Browser.getEventln(xxx) Browser.getEventOut(xxx) 


Avatar 


eventln MFNode 
set_myAvatarNodes 

Sets myAvatar nodes (for a 
createVrmIFromURL callback) 

eventln SFBool 
set_showMyAvatar 

Toggles 3rd person mode 

exposedField SFString 
myAvatarURL 

Current avatar URL 

exposedField SFNode 
bound Avatar 

Bound (displayed) avatar node (may contain wrapper around 
myAvatarUrl) 

exposedField SFNode 
myAvatar 

Node currently used as myAvatar node 

exposedField SFString 
myAvatarName 

Current avatar nickname 

exposedField SFVec3f 
followDolly 

x,y,z relative translation distance for 3rd person view 

exposedField SFVec3f 
followOrbit 

x,y rotation value for 3rd person viewing mode 
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exposed Field SFVec3f 
followPan 

x,y pan rotation value for 3rd person viewing mode 


Viewpoint 


eventOut SFVec3f 
viewpointPosition 

Global viewer position 

eventOut SFRotation 
viewpointOrientation 

Global viewer orientation 

exposedField MFNode 
viewpoints 

Complete list of viewpoints 

exposedField SFNode 
boundViewpoint 

Currently bound viewpoint (top of stack) 

exposedField MFNode 
boundViewpointStack 

Other stacked viewpoints (if any) 


Navigation 


exposedField SFNode 
boundNavigationlnfo 

Currently bound Navigation Info 

exposedField MFNode 
boundNavigationlnfoStack 

Other stacked Navigationlnfos 


Fog 


exposedField SFNode 
boundFog 

Currently bound fog 

exposedField MFNode 
boundFogStack 

Other stacked Fog nodes 


Background 
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Currently bound Background node 
Other stacked Background nodes 

VRML Browser window 


exposedField SFNode 
boundBackground 

exposedField MFNode 
boundBackgroundStack 


eventOut SFVec2f windowSize Rendering window width and height 

eventOut SFFIoat Aspect ratio of rendering window 

windowAspect 


VRML Browser 

exposedField SFString name Browser name 

exposedField SFString Browser version 

version 


VRML world 


exposedField URL of currently loaded world (set observer to get a world changed 

SFString notification) 

worldUrl 

exposedField List of TouchSensors the mouse is over 

MFNode 

overTouchSensors 


exposedField List of VisibilitySensors and Occlusion nodes currently assumed to be 

MFNode visible 

active VisibilitySensor 
s 

exposedField List of scenes with prototypes (loaded via EXTERNPROTO URL ..) 

MFNode 

protoScenes 


exposedField 

MFNode 


Additonal set of nodes rendered after scene 
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foreground 

eventOut SFTime Master clock 

time_changed 

5.4 Extensions to field objects object 

Methods 


string getType() 

Returns type of the field as VRML fieldType name 

string toString() 

Converts field to its VRML string representation. 


5.5 Extensions to vrmlscript SFNode object 

Methods 


string getType() 

Returns type of the node as VRML nodeType or prototype name 

string getName() 

Returns nodes DEF name if available. Node name is not available if 
node is part of a PROTO and the node in this instance was copied. 

node copy() 

Creates a copy of the node (no deep copy on SFNode / MFNode 
fields is done) 

object getEventln 
(string 

eventlnName) 

Gets eventln object of node 

boolean 
hasEventln 
(string eventName) 

Returns true if node has an eventln named eventName 

object getEventOut 
(string 

eventOutName) 

Gets eventOut object of node 

boolean 
hasEventOut 
(string eventName) 

Returns true if node has an eventOut named eventName 

VrmIMatrix 

getMatrix() 

Returns Matrix of Transform, MatrixTransform or last Matrix of 

HUD, Billboard or related VRML 1.0 nodes 

boolean setMatrix 
(vrmIMatrix) 

Sets Matrix of Transform or MatrixTransform nodes, returns false if 
matrix can not be set. 

MFVec3f getBBox() 

Returns bounding box of the node. Return value [0] contains the 
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min position, value[1] the max position. The function is optimized if 
called for a Geometry node. 


5.6 Extensions to vrmlscript MFTime object 

Supports the same members and methods as MFFIoat object, but values are 
stored in double precision. 


5.7 Extensions to vrmlscript MFVec3f object 


setByVertexT ransfor 
m (MFVec3f 
srcPoints, 

MFInt32 srclndex, 
MFVec3f translation, 
MFRotation rotation, 
MFVec3f scale, 
MFRotation 
scaleOrientation, 
MFVec3f center) 


This assignment function performs a series of transformations to 
coordinates in srcPoints and assigns the result to the object. The 
operation is comparable to a nested Transform scene graph used to 
animate a hierarchical model like an Avatar. 

The last 5 parameters can be omitted to speed up the operation. If there 
are n groups of vertices to transform, length of srclndex must be n*3 
and the length of each transformation data array must be at least n or 0. 


The operation expressed in pseudo code: 

VrmIMatrix matrixStack[]; 
var index; 

for( index=0; index<srclndex.length/3; index+=1) 

{// for all indices in groups by 3 
var level=srclndex[index*3];// get the nesting level 
var startlndex=srclndex[index*3+1]; // start vertex index 
var endlndex=srclndex[index*3+2]; // end vertex index 


// compute transformation, right most arguments can be omitted 
// for speed 

matrixStack[level]=m.setTransform(translation[index], rotation[index], 
scaleFactor[index],scaleOrientation[index], center[index]) ; 

if (level 1=0) { 

matrixStack[level].MultiplyRight( matrixStack[level-1]); 

// combine with parent 

} 

for(var i=startlndex;i<endlndex;i++){ 

// transform the Vec3f subset 
this[i] = matrixStack[level] * srcPoints[i]; 

} 


MFVec3f getBBox() Returns the bounding box of the array of Vec3f. Return 

value [0] returns the min position, value[1] the max 
position. 
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5.8 Extensions to vrmlscript Math object 


double atan2 
(double dy, double dx) 

arc tangent -PI .. PI 

double cosh(double x) 

Computes hyperbolic cosine of x 

double sinh(double x) 

Computes hyperbolic sine of x 

double tanh(double x) 

Computes hyperbolic tangent of x 

double randomGaussian() 

gaussian random number -1 ..1 


double noise(double x) Evaluates solid noise function on x 

Extensions to vrmlscript SFString object 


int getCharCodeAt(index) 

Returns character code as integer at position index 

string fromCharCode(int1, 

.... intn) 

Constructs and returns a new string composed of the 
given sequence of character codes 


5.9 Extensions to vrmlscript SFImage object 


SFImage new SFImage 
(int width,int height, 
int components, 

MFFIoat pixels) 

Constructs SFImage using a float array of length 
width*height*components. This function can be used 
to avoid the time consuming pixel packing in 
vrmlscript for dynamically computed SFImage 
objects. 


5.10 Extensions to vrmlscript MFNode object 


boolean add(SFNode node) 

Adds a single SFNode 
to the field 

boolean remove(SFNode node) 

Removes a single 

SFNode from the field 

int find(SFNode node) 

Returns index of a node 
in field; 

-1 if not found. 

SFNode 

findByName(String name) 

Returns first node with 
a matching name; null if 
not found. 


